home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 27 / q27.d81 / t.dt128 docs 7 < prev    next >
Text File  |  2022-08-28  |  15KB  |  382 lines
  1.  
  2.  
  3.  Directory Editor
  4.  ----------------
  5.  
  6.     This module is a disk directory editor which is accessed from the
  7. "Special Disk Functions" in the "Disk Functions" menu.
  8.  
  9.  Disk Directory:
  10.  
  11.     Shows the directory of the default device and drive.
  12.  
  13. Device/Drive:
  14.  
  15.     Selects the device and drive to be used.  This setting uses the system
  16. device and drive (changing this is the same as changing the device and
  17. drive in the disk functions menu).
  18.  
  19. Edit Directory:
  20.  
  21.     This options allows you to edit and manipulate disk directories.  The
  22. following commands are available:
  23.  
  24.  CRSR UP/DOWN - moves the cursor up or down through the directory window
  25.  
  26.  SPACE - toggles the select status of a file.  A check mark appears before
  27. selected file names.
  28.  
  29.  HOME - moves the cursor to the top of the window.  If the cursor is
  30. already at the top of the window it moves to the first entry.
  31.  
  32.  a - selects all file names (you'll see a check mark before the file name)
  33.  
  34.  c - "cleans" the directory by removing deleted files from the listing.
  35. This has the possible benefit of shortening the directory chain.
  36.  
  37.  d - "deletes" all marked files.  If you use this option you should
  38. validate the disk to free up the sectors used by that file
  39.  
  40.  e - edits the entry at the cursor position.  You can abort the edit at any
  41. time by pressing escape.
  42.  
  43.     Start by entering a file name.  If you wish to keep the current file
  44. name press return on a blank input line.
  45.  
  46.     The next field to edit is the file type.  There are 12 possible types:
  47.  
  48.     "del" a rarely used commodore file type, "seq", "prg", "usr", "rel",
  49. and "cbm."  The CBM file type is valid for the 1581 only.  The remaining 6
  50. types are the same only "locked" (denoted by a "<" after the file type).  A
  51. locked file cannot be scratched with the normal DOS scratch "s0:file name"
  52. command.  Press any key to toggle through the possible file types, press
  53. RETURN when the correct type appears.
  54.  
  55.     The next fields to edit are the track and sector of the first block for
  56. the file.  Only valid track/sector values are accepted.  If you press
  57. return on a blank line, or enter a non-numeric or bad value, the previous
  58. value is returned.
  59.  
  60.     The next field is the file size, in blocks.
  61.  
  62.     The remaining fields are for relative files only.  The first two values
  63. are the track and sector of the first side sector.  The last field is the
  64. size of each record in the file.
  65.  
  66.  E - allows you to edit/change the disk name and the id which appears in
  67. the directory listings.  This is a cosmetic change only.  The disk id used
  68. when formatting is still the "real" id which appears in the header blocks
  69. of each sector.
  70.  
  71.  l - allows you to add a divider to the directory.  This will not work if
  72. the directory is full.
  73.  
  74.  m - allows you to move 1 file to a new location.  Select a file, then move
  75. the cursor to the desired position, then press "m."  If more than one file
  76. is selected, only the first selected file is moved.
  77.  
  78.  n - advance through the window 1 page.
  79.  
  80.  s - sorts all selected files by file name.
  81.  
  82.  S - scratches all marked files.  You are asked if you are sure before the
  83. commands begins.  Make sure are have only the files you want scratched
  84. marked because once you answer yes you cannot stop the command.  If you
  85. accidentally scratch a file you can immediately un-delete it.
  86.  
  87.  t - toggles the select status of all files.
  88.  
  89.  u - un-deletes all marked files.  You will need to edit the entry after
  90. using this command.  If you re-write a directory after using this command
  91. you should validate the disk to update the BAM.
  92.  
  93.  w - re-writes the directory using the information in the buffer.  After
  94. the directory has been re-written the drive is initialized.  You will then
  95. be asked if you want to validate the disk.  Usually you will want to,
  96. sometimes it is necessary (un-deleting or deleting a file, or the if
  97. directory size changes).  It is safest to answer yes to the validation
  98. prompt.
  99.  
  100.  The headings of the window are:
  101.  
  102.  File name - obvious
  103.  Type - the file type
  104.  Size - the size of the file in blocks
  105.  T - Track of first block in file
  106.  S - Sector of the first block in file
  107.  
  108.  for relative files
  109.  
  110.  Rt - track of first side sector
  111.  Rs - Sector of first side sector
  112.  Len - length of each record in the file
  113.  
  114.  Notes:
  115.  
  116.     This utility accesses the main default device and drive for all
  117. functions.  If you edit a subdirectory you cannot validate the subdirectory
  118. with the validate option after re-writing the directory.  That validate
  119. command always validates the root directory.  If you need to validate a
  120. subdirectory you will have to use the "/" command to get to the proper
  121. subdirectory and then issue a "v0" command.
  122.  
  123.  
  124.  Disk Editor
  125.  -----------
  126.  
  127.     This utility is a disk sector editor.  Access this utility from the
  128. "Special Disk Functions" in the "Disk Functions" menu.  The cursor keys
  129. move the cursor around.  The home key moves the cursor to the upper left
  130. (first byte) on the display.
  131.  
  132. Menu page 1 commands
  133.  
  134.  R ead a sector
  135.  
  136.  W rite a sector
  137.  
  138.     For these commands you will be prompted to enter a track number and
  139. sector number.  If either input is blank the command is aborted.
  140.  
  141.  @ Edits a byte.  You can enter the new value as a decimal number, or hex
  142. by typing a "$" as the first character.
  143.  
  144.  T ext input - enters text input mode.  Press ESCape to exit this mode.
  145.  
  146.  J ump to link - assumes the character under the cursor is the track, and
  147. the byte following is the sector, then tries to read that sector.  Useful
  148. for following the links of a file.
  149.  
  150.  X - exit to ML monitor.  Read the section on the machine language monitor.
  151. When you first enter the monitor a "d" disassemble command will start at
  152. the address of the cursor.  Bank 0 $0400-$04FF is used as a sector buffer
  153.  
  154.  +  Advance 1 sector or memory page -  Back up 1 sector or memory page
  155.  
  156.  D - toggles the default drive
  157.  
  158.  N - Next menu
  159.  
  160. Menu page 2 commands
  161.  
  162.  I - do a disk drive memory read "m-r"
  163.  
  164.  O - do a disk drive memory write "m-w"
  165.  
  166.     To do a memory write position the cursor on the first character to
  167. write and press the letter "o".  Use the cursor keys to highlight the area
  168. you want to write.  When done press RETURN.  Then enter the page to write
  169. to.  Press ESCape to abort at any point.
  170.  
  171.  E - memory execute.  Enter the address where the ML program is located in
  172. 1541 memory
  173.  
  174.  B - block execute.  Enter the track/sector to execute.
  175.  
  176.  F7 - toggles the buffer.  Open it if you want to enter the ML monitor and
  177. you want the monitor to send its output to the buffer
  178.  
  179.  A -  sends the 256 byte block to the capture buffer
  180.  
  181.  C -  Capture the current screen to the capture buffer.  From there you can
  182. print it.
  183.  
  184.  
  185.  Font Editor
  186.  -----------
  187.  
  188.     This module allows you to edit character sets.
  189.  
  190.  
  191. When you enter this module you are given the following options:
  192.  
  193.  Edit Upper Case
  194.  
  195.     Copies the standard Commodore Upper Case/Graphics character set to the
  196. font editor work space.
  197.  
  198.  Edit Lower Case
  199.  
  200.     Copies the standard Commodore Lower Case/Upper Case character set to
  201. the font editor work space.
  202.  
  203.  Edit Ascii
  204.  
  205.     Copies the Ascii/Ansi character set to the font editor work space.
  206.  
  207.  Edit Disk Font
  208.  
  209.     Loads a font from disk to the font editor workspace.
  210.  
  211. After you select one of the above options you enter the font editor where
  212. you may then edit the character shapes.  The editor commands are:
  213.  
  214.  F           - Flips the current character top to bottom
  215.  M           - creates mirror image of current character
  216.  O           - recalls the shape that the character was when you cursored
  217.                to it.
  218.  R           - rotates current character 90 degrees to the right.
  219.  S           - Saves the character set to the capture buffer.  The load
  220.                address used is $7000 except when you edit the Ascii
  221.                set in which case $E800 is used.  If you load a font from
  222.                disk the save will use the same load address that the
  223.                font file used.  Since the save is done to the capture
  224.                buffer you will probably want to clear and close the buffer
  225.                before you edit.  After you use this command you will need
  226.                to use the normal buffer save option to save the character
  227.                set to disk.
  228.  F1          - Shift curr